home *** CD-ROM | disk | FTP | other *** search
/ Tech Arsenal 1 / Tech Arsenal (Arsenal Computer).ISO / tek-05 / igo14.zip / READ_ME.IGO < prev    next >
Text File  |  1991-07-21  |  11KB  |  295 lines
  1.  
  2. July 21, 1991
  3.  
  4. Welcome to IGO!
  5.  
  6. I wrote IGO as a diversion and to better understand Borland's Turbo Pascal,
  7. DOS, directories, etc.  I also did it because I have a 100 MB hard disk and
  8. needed a quick way to remember all the path names.  I can remember short
  9. names that refer to some subject, but I have no memory for several levels.
  10.  
  11.    * IGO's alias naming allows you (and me) to create any directories you
  12.      need to and refer to them by a single, easy to remember name.  It cuts
  13.      down on typing too!
  14.  
  15.    * You can also save the current location to allow a quick return later.
  16.      Great for BATch programs!
  17.  
  18.    * Ever wondered where a file was?  IGO can search for a file (no wild
  19.      cards) and take you to that directory!
  20.  
  21.    *** NEW ***
  22.  
  23.    * Create the initial list of directory names using the included
  24.      IGODIR.EXE program!  Now let IGODIR create your list of potential
  25.      alias' and edit it with IGO or your favorite text editor.
  26.  
  27.  
  28. Try IGO for a while and pass it along to your friends.  But, remember, IGO
  29. is not free.  It is Shareware.  Shareware means that you can try it for a
  30. few days or weeks to see if you like it before paying the $10 registration
  31. fee.  Using this software after that period of time is a violation of US
  32. Copyright laws.
  33.  
  34. Let me know how you like IGO.  I distribute the software through CompuServe
  35. and several public Bulletin Board Systems (BBSs) rather than shipping
  36. costly diskettes.  Write me at the Silver Wolf Software address or send a
  37. message in CompuServe to 71441,1637.
  38.  
  39.  
  40. Mark S. Daly
  41.  
  42.  
  43. Installing IGO
  44. --------------
  45.  
  46. IGO should exist within your command PATH.  If used this way, IGO can find
  47. itself and will create two files, IGO.DIR and IGO.LOC, as needed in the
  48. same place.  You should not change the name of "IGO.EXE" since the program
  49. won't be able to find itself.
  50.  
  51. Ok, there is another way to get around this.  By setting a DOS environment
  52. variable (using the SET command), you can force IGO to look in a specific
  53. directory for the IGO.DIR and IGO.LOC files.
  54.  
  55.     SET IGO=C:\MISC
  56.  
  57. will tell IGO to create - and later look for - these files in the C:\MISC
  58. directory.
  59.  
  60.  
  61. Using IGO on a LAN
  62. ------------------
  63.  
  64. I've found that IGO gets confused searching through the mapped pseudo disk
  65. drives provided by Novell and, therefore, needs you to set the "IGO" DOS
  66. variable (as mentioned above).  I don't know about other LAN's since I
  67. don't have access to any.
  68.  
  69.  
  70. IGO Help
  71. --------
  72.  
  73. IGO's help is online.  Simply enter "IGO" and press then enter key.  Press
  74. the ESC (escape) key to get out of the help.
  75.  
  76.  
  77. Running IGO
  78. -----------
  79.  
  80. IGO uses a hyphen ("-") to indicate a command.  So, "IGO -L" will tell IGO
  81. the "L" is a command; otherwise, it would be treated as a directory name.
  82. By the way, IGO is not case sensitive - L and l are the same thing to IGO.
  83.  
  84. That said, what do you have to type to get IGO to do anything for you?
  85.  
  86.    IGO name             Tells IGO to try to go to the "name" directory.
  87.                         If the IGO.DIR file is found, the file will be
  88.                         searched for "name" to see if it is an alias.
  89.  
  90.                         If IGO cannot switch into the directory, it will
  91.                         place a "\" before the name to see if the directory
  92.                         is a top level directory and you just forgot the
  93.                         initial backslash.
  94.  
  95.                         If it still cannot switch into the directory, you
  96.                         will remain in the current directory.
  97.  
  98.    IGO -a name path     Add a new "name" to the IGO.DIR directory list and
  99.                         indicate that the "name" references the "path".
  100.                         If the "name" already exists, you will be told so
  101.                         and the add will not take place.
  102.  
  103.                         Some pre-defined alias' already exist; these names
  104.                         should not be used.  These names include:
  105.  
  106.                            UP      OFF     OVER    ROOT    BOOT
  107.  
  108.    IGO -d name          Remove the "name" from the alias list.
  109.  
  110.    IGO -u name path     Update/change the "path" for the "name" alias.
  111.                         If the "name" does not exist, it will be added.
  112.  
  113.    IGO -l               List the alias names currently defined.
  114.  
  115.  
  116. Going Places
  117. ------------
  118.  
  119. Given a name, IGO will try to find the name in the file IGO.DIR.  If found,
  120. the "name" is replaced by the actual path name found there.  IGO will then
  121. try to "go" to the requested directory name.
  122.  
  123. If it cannot it will try to "go" to the root directory and "into" the named
  124. directory just in case you may have forgotten the initial backslash.
  125.  
  126. If the attempt still fails, you will find you have gone nowhere.
  127.  
  128. One other thing.  If IGO finds any ":" or "\" characters in the original
  129. name, it will not look for an alias.  This is a good clue if you want to
  130. by-pass the look up.
  131.  
  132.  
  133. Substituting DOS Variables
  134. --------------------------
  135.  
  136. IGO lets you substitute a DOS environment variable for a path name or part
  137. of a path name.  For example:
  138.  
  139.         IGO \USER\%MAILNAME%
  140.  
  141. will look for a DOS "set" variable called MAILNAME and substitute what it
  142. finds pas part of the path name.  In this case, if MAILNAME was set to
  143. MARKD, then we would try to go to \USER\MARKD.
  144.  
  145. Of course, normal rules about path/directory names apply.
  146.  
  147.  
  148. Saving the Current Location
  149. ---------------------------
  150.  
  151. IGO can save off the current directory in the IGO.LOC file to allow a quick
  152. return later.  This is especially useful for BATch programs.  Almost all of
  153. my batch programs return me to the directory where I started when I ran the
  154. program.
  155.  
  156. To do this you use the "-S" (for "save") command.  Therefore,
  157.  
  158.         IGO -s UTIL\DOCS
  159.  
  160. will save off the current location and try to go to "UTIL\DOCS".  To return
  161. later,
  162.  
  163.         IGO -r
  164.  
  165. The "R" stands for "Return".  The IGO.LOC file will automatically be
  166. removed during the return.
  167.  
  168. You can manually remove the IGO.LOC file with the command "IGO -C" (for
  169. "clear").
  170.  
  171.  
  172. Sorting the IGO Alias Directory
  173. -------------------------------
  174.  
  175. You can sort the IGO.DIR file simply by using the SORT program provided
  176. with DOS.  Check out your DOS documentation about how to sort files.
  177.  
  178.  
  179. Finding Files
  180. -------------
  181.  
  182. Have you ever been looking for a file but couldn't seem to find it?  Well,
  183. IGO can look for the file and then TAKE YOU TO THAT DIRECTORY!  The file
  184. doesn't have to be in the command path; IGO searches the entire disk.
  185.  
  186. IGO can search the entire disk and if the file is found, change into the
  187. directory where the file was found.  If there is more than file by the same
  188. name, IGO gives you the opportunity to choose which one you meant.
  189.  
  190. No wild card characters (* and ?) are not allowed since this is a search
  191. for a specific file.  If enough people ask for it, however, I might be
  192. persuaded to add this capability.
  193.  
  194. So, how do you do this?  With the "F" (for Find) command.
  195.  
  196.         IGO -f MYLOGO.PCX
  197.  
  198. The above command will ask IGO to search the entire disk for the file
  199. "MYLOGO.PCX" and go to that directory.
  200.  
  201. While IGO is searching the disk, you will see a message which shows you the
  202. number of files IGO has examined.  I put this message out because some
  203. large hard disks can take a while (like mine) to search - no matter how
  204. fast the disk access may be.
  205.  
  206. Can you stop a search?  Yes.  Pressing the ESC (escape) key will stop the
  207. search at any time.
  208.  
  209.  
  210. Quick Find
  211. ----------
  212.  
  213. Sometimes I only want to find the file and go there.  I don't want to be
  214. bothered with questions about multiple copies...
  215.  
  216. So, the -F1 command (as opposed to -F only) has been added.  If you use the
  217. command as shown above, but add a "1" after the "F" (no spaces allowed),
  218. IGO will take you to the directory where the FIRST occurrance of the file
  219. was found.
  220.  
  221. This not only cuts the disk search time as soon as a file is found but it
  222. takes you to that directory without stopping for questions.
  223.  
  224.  
  225. IGO Change History
  226. --------------------------------------------------------------------------
  227.  
  228. v1.0    Initial release to CompuServe.
  229.  
  230. v1.1    Fix a problem with long path names.
  231.  
  232. v1.2    Add ability to use '.' as "current directory" when adding
  233.         new alias names.  So, IGO -A .\TODAY will give the current
  234.         directory path followed by "\TODAY".
  235.  
  236. v1.3    If -R (return) is set then automatically set -C (clear old
  237.         location) unless -C is found on command line.  If -C is
  238.         explicitly on command line, do whatever it says.  This way,
  239.         you can simply return with -R and clear the old location name
  240.         or explicitly ask IGO not to clear the location (-C-).
  241.  
  242.         If the destination is not found, say so.
  243.  
  244.         Fix the exit value:     1 = initialization error (rare)
  245.                                 2 = option conflict error
  246.                                 3 = error changing directory
  247.  
  248.         Add -F (Find file) option to search for a specific file by
  249.         name.  Currently, only a full and complete file name matched
  250.         exactly will work.
  251.  
  252.         Add -F1 variation to allow finding a file w/o asking questions.
  253.         The first file found will be the trigger to go to that directory.
  254.  
  255.  
  256. IGO Change History
  257. --------------------------------------------------------------------------
  258.  
  259. v1.4    Correct a problem where alias names might become confused if the
  260.         whole alias name (or a similar actual directory name) was not
  261.         provided.  That is, "X" might return the alias X-RATED or XTRA;
  262.         depending upon which was found first.
  263.  
  264.         Add "/?" help syntax to help those using MS-DOS v5.0.  This option
  265.         requests help.  "-?" is also valid.
  266.  
  267.         Add the IGODIR program to build the list of possible alias
  268.         directory names.  This program examines the current disk (if you're
  269.         on C: it will look on C:\) and builds a file called IGODIR.DIR
  270.         layed out just like the IGO.DIR file.  You can edit this ascii text
  271.         file to eliminate duplicates and/or change/delete the alias names
  272.         found there.
  273.  
  274. --------------------------------------------------------------------------
  275.  
  276. IGO is not free or public domain; IGO is distributed as SHAREWARE.  This
  277. means that you don't have to worry about buying something you can't use
  278. and then have troubles returning it.  Shareware allows you to try before
  279. you buy.  Use it for a few weeks and, if you find it useful, register the
  280. program with the author.  The nominal registration fee will get you a free
  281. copy of the most recent software and, optionally, notice of any upgrades.
  282.  
  283. IGO is marketed and distributed by Silver Wolf Software through an agreement
  284. with the author.  If you have any questions, call (818) 889-0800 or send a
  285. message in CompuServe to 71441,1637 (that's me).
  286.  
  287. REGISTER TODAY!
  288.  
  289.                  Silver Wolf Software           (compuserve: 76470,245)
  290.                  31255 Cedarvalley Drive
  291.                  Suite 211
  292.                  Westlake Village, CA 91361
  293.  
  294. IGO                                         Copyright (c) 1990 Mark S. Daly
  295.